QTreeWidget Class

Constructs a tree widget with the given parent.

Clears the tree widget by removing all of its items and selections.

Note: Since each item is removed from the tree widget before being deleted, the return value of QTreeWidgetItem::treeWidget() will be invalid when called from an item's destructor.

See also takeTopLevelItem(), topLevelItemCount(), and columnCount().

Closes the item. This causes the tree containing the item's children to be collapsed.

See also expandItem(), currentItem(), itemAt(), and topLevelItem().

This signal is emitted when the current item changes. The current item is specified by current, and this replaces the previous current item.

See also setCurrentItem().

Expands the item. This causes the tree containing the item's children to be expanded.

See also collapseItem(), currentItem(), itemAt(), topLevelItem(), and itemExpanded().

This signal is emitted when the user activates an item by single- or double-clicking (depending on the platform, i.e. on the QStyle::SH_ItemView_ActivateItemOnSingleClick style hint) or pressing a special key (e.g., Enter).

The specified item is the item that was clicked, or nullptr if no item was clicked. The column is the item's column that was clicked, or -1 if no item was clicked.

This signal is emitted when the contents of the column in the specified item changes.

This signal is emitted when the user clicks inside the widget.

The specified item is the item that was clicked. The column is the item's column that was clicked. If no item was clicked, no signal will be emitted.

This signal is emitted when the specified item is collapsed so that none of its children are displayed.

Note: This signal will not be emitted if an item changes its state when collapseAll() is invoked.

See also QTreeWidgetItem::isExpanded(), itemExpanded(), and collapseItem().

This signal is emitted when the user double clicks inside the widget.

The specified item is the item that was clicked, or nullptr if no item was clicked. The column is the item's column that was clicked. If no item was double clicked, no signal will be emitted.

This signal is emitted when the mouse cursor enters an item over the specified column. QTreeWidget mouse tracking needs to be enabled for this feature to work.

This signal is emitted when the specified item is expanded so that all of its children are displayed.

See also setItemExpanded(), QTreeWidgetItem::isExpanded(), itemCollapsed(), and expandItem().

This signal is emitted when the user presses a mouse button inside the widget.

The specified item is the item that was clicked, or nullptr if no item was clicked. The column is the item's column that was clicked, or -1 if no item was clicked.

This signal is emitted when the selection changes in the tree widget. The current selection can be found with selectedItems().

Ensures that the item is visible, scrolling the view if necessary using the specified hint.

See also currentItem(), itemAt(), and topLevelItem().

Destroys the tree widget and all its items.

Appends the item as a top-level item in the widget.

This function was introduced in Qt 4.1.

See also insertTopLevelItem().

Appends the list of items as a top-level items in the widget.

See also insertTopLevelItems().

Closes the persistent editor for the item in the given column.

This function has no effect if no persistent editor is open for this combination of item and column.

See also openPersistentEditor() and isPersistentEditorOpen().

Returns the current column in the tree widget.

This function was introduced in Qt 4.1.

See also setCurrentItem() and columnCount().

Returns the current item in the tree widget.

See also setCurrentItem() and currentItemChanged().

Reimplements: QAbstractItemView::dropEvent(QDropEvent *event).

Handles the data supplied by a drag and drop operation that ended with the given action in the index in the given parent item.

The default implementation returns true if the drop was successfully handled by decoding the mime data and inserting it into the model; otherwise it returns false.

See also supportedDropActions().

Starts editing the item in the given column if it is editable.

Reimplements: QAbstractItemView::event(QEvent *event).

Returns a list of items that match the given text, using the given flags, in the given column.

Returns the item used for the tree widget's header.

See also setHeaderItem().

Returns the QModelIndex associated with the given item in the given column.

Note: In Qt versions prior to 5.7, this function took a non-const item.

See also itemFromIndex() and topLevelItem().

Returns the index of the given top-level item, or -1 if the item cannot be found.

See also sortItems() and topLevelItemCount().

Inserts the item at index in the top level in the view.

If the item has already been inserted somewhere else it won't be inserted.

See also addTopLevelItem() and columnCount().

Inserts the list of items at index in the top level in the view.

Items that have already been inserted somewhere else won't be inserted.

This function was introduced in Qt 4.1.

See also addTopLevelItems().

Returns the tree widget's invisible root item.

The invisible root item provides access to the tree widget's top-level items through the QTreeWidgetItem API, making it possible to write functions that can treat top-level items and their children in a uniform way; for example, recursive functions.

This function was introduced in Qt 4.2.

Returns whether a persistent editor is open for item item in column column.

This function was introduced in Qt 5.10.

See also openPersistentEditor() and closePersistentEditor().

Returns the item above the given item.

This function was introduced in Qt 4.3.

Returns a pointer to the item at the coordinates p. The coordinates are relative to the tree widget's viewport().

See also visualItemRect().

This is an overloaded function.

Returns a pointer to the item at the coordinates (x, y). The coordinates are relative to the tree widget's viewport().

Returns the item visually below the given item.

This function was introduced in Qt 4.3.

Returns a pointer to the QTreeWidgetItem associated with the given index.

See also indexFromItem().

Returns the widget displayed in the cell specified by item and the given column.

This function was introduced in Qt 4.1.

See also setItemWidget().

Returns an object that contains a serialized description of the specified items. The format used to describe the items is obtained from the mimeTypes() function.

If the list of items is empty, nullptr is returned rather than a serialized empty list.

Returns a list of MIME types that can be used to describe a list of treewidget items.

See also mimeData().

Opens a persistent editor for the item in the given column.

See also closePersistentEditor() and isPersistentEditorOpen().

Removes the widget set in the given item in the given column.

This function was introduced in Qt 4.3.

Returns a list of all selected non-hidden items.

See also itemSelectionChanged().

Sets the current item in the tree widget.

Unless the selection mode is NoSelection, the item is also selected.

See also currentItem() and currentItemChanged().

Sets the current item in the tree widget and the current column to column.

This function was introduced in Qt 4.1.

See also currentItem().

Sets the current item in the tree widget and the current column to column, using the given command.

This function was introduced in Qt 4.4.

See also currentItem().

Sets the header item for the tree widget. The label for each column in the header is supplied by the corresponding label in the item.

The tree widget takes ownership of the item.

See also headerItem() and setHeaderLabels().

Same as setHeaderLabels(QStringList(label)).

This function was introduced in Qt 4.2.

Adds a column in the header for each item in the labels list, and sets the label for each column.

Note that setHeaderLabels() won't remove existing columns.

See also setHeaderItem() and setHeaderLabel().

Sets the given widget to be displayed in the cell specified by the given item and column.

The given widget's autoFillBackground property must be set to true, otherwise the widget's background will be transparent, showing both the model data and the tree widget item.

This function should only be used to display static content in the place of a tree widget item. If you want to display custom dynamic content or implement a custom editor widget, use QTreeView and subclass QStyledItemDelegate instead.

This function cannot be called before the item hierarchy has been set up, i.e., the QTreeWidgetItem that will hold widget must have been added to the view before widget is set.

Note: The tree takes ownership of the widget.

This function was introduced in Qt 4.1.

See also itemWidget() and Delegate Classes.

Reimplements: QTreeView::setSelectionModel(QItemSelectionModel *selectionModel).

Returns the column used to sort the contents of the widget.

This function was introduced in Qt 4.1.

See also sortItems().

Sorts the items in the widget in the specified order by the values in the given column.

See also sortColumn().

Returns the drop actions supported by this view.

See also Qt::DropActions.

Removes the top-level item at the given index in the tree and returns it, otherwise returns nullptr;

See also insertTopLevelItem(), topLevelItem(), and topLevelItemCount().

Returns the top level item at the given index, or nullptr if the item does not exist.

See also topLevelItemCount() and insertTopLevelItem().

Returns the rectangle on the viewport occupied by the item at item.

See also itemAt().